home *** CD-ROM | disk | FTP | other *** search
/ Atari Gold / Atari Gold.iso / papyrus / module / cyp2rtf.txt < prev    next >
Encoding:
Text File  |  1994-11-24  |  6.4 KB  |  193 lines
  1. CYP2RTF - Was das?
  2.  
  3.     CYP2RTF kovertiert CyPress-Dateien ins RTF-Format. Damit können 
  4.     fast alle Formatierungsanweisungen aus CyPress übernommen werden.
  5.     Das RTF-Format wird auf dem Atari z.B. von Papyrus verstanden.
  6.     Auf PC, MAC usw. können die meisten Textverarbeitungen das RTF-
  7.     Format lesen und schreiben.
  8.     Leider haben etliche Programme das Format recht schlampig oder 
  9.     unvollständig implementiert, wodurch es zu Unstimmigkeiten 
  10.     kommen kann.
  11.  
  12. Folgendes wird konvertiert:
  13.  
  14.     - Seitenformatierung und Papierformat
  15.     - Dokumenteninfo
  16.     - Kopf und Fußzeilen für gerade und ungerade Seiten
  17.     - Zeichensätze (Systemzeichensatz als Zeichensatz "ATARI", 10pt)
  18.     - Attribute
  19.     - Absatz- und Zeilenformatierung
  20.     - Tabulatorpositionen und -arten
  21.     - Zeichen für Dezimaltab (s.u.)
  22.     - Fußnoten
  23.     - Formelbereiche (als absolut positionierte Objekte mit \posx\posy)
  24.     - Tabellen (formatiert mit Tabs, Linien-Tabs werden entfernt, s.u.)
  25.     - Formularfelder (als Tabulatorsprünge)
  26.     - Serienbriefsymbole (s.u.)
  27.     - Sperrung, Kerning
  28.     - Trennungen
  29.  
  30. Folgendes fällt flach:
  31.  
  32.     - Rechenanweisungen
  33.     - Bilder
  34.     - Zeilenklammerung (außer in Tabellen)
  35.  
  36. Zeichensätze:
  37.  
  38.     RTF geht normalerweise von Vektorzeichensätzen mit jeweiliger 
  39.     Angabe der Größe aus. CYP2RTF versucht für Pixelzeichensätze die 
  40.     Größe aus dem Namen zu ermitteln (wenn -fs angegeben wird, s.u.), 
  41.     kann aber auch dem Reader die automatische Bestimmung der 
  42.     Pixelzeichensatzgröße überlassen, wenn dieser das Kommando 
  43.     \fsauto unterstützt (z.B. Papyrus).
  44.  
  45.     Die Namen der Zeichensätze stimmen für Speedo und z.B. TrueType 
  46.     auch bei gleichen Fonts meist nicht, oder zumindest nicht ganz 
  47.     überein. "SWISS 721" heißt z.B.  "SWISS721 BT".
  48.     Für Pixelzeichensätze ist die Situation natürlich noch vertrackter.
  49.     Wer vom Atari auf eine andere Plattform exportieren will, oder das 
  50.     Kommando \fsauto für Pixelzeichensätze nicht verwenden kann, 
  51.     sollte deshalb mein Programm "TRANSFNT" verwenden. Mit diesem 
  52.     "Transfonter" können die Namen der Zeichensätze angepaßt werden, 
  53.     und für Pixelfonts kann die tatsächliche Größe eingestellt werden.
  54.  
  55. Tabellen:
  56.  
  57.     Trennstriche von Tabellen werden als unterstrichene Tabs und mit 
  58.     \vline ausgegeben, wenn der Parameter -tab (s.u.) angegeben wird. 
  59.     Da das bis jetzt aber sowieso kein Programm richtig interpretiert, 
  60.     und der Import dann unschön ausfällt, werden die Trennlinien von 
  61.     Tabellen normalerweise (ohne d.h. Parameter -tab) gefiltert.
  62.  
  63.     Bis Version 1.5 erzeugte CyPress jedoch keine Tabelleninfos. Bei 
  64.     Tabellen, die mit älteren Versionen erzeugt wurden, können die 
  65.     Trennstriche deshalb nicht entfernt werden. Zur Aktualisierung 
  66.     reicht es nicht, ein Dokument mit einer neueren CyPress-Version zu 
  67.     laden, und wieder zu speichern, da auch CyPress selbst nicht 
  68.     erkennt, daß es sich um Tabellen handelt. Für jede Tabelle muß 
  69.     deshalb der Tabellendialog aufgerufen werden.
  70.  
  71. Aufruf von CYP2RTF.PRG:
  72.  
  73.     CYP2RTF <CyPress-Pfad> [<RTF-Pfad>] [-fs] [-rtf10] [-tab]
  74.  
  75.     Der Eingabepfad muß die Endung ".CYP" oder ".BAK" haben.
  76.     Wenn kein Eingabepfad angegeben wird, erscheint eine 
  77.     Dateiauswahlbox, in der die zu wandelnde Datei ausgewählt werden 
  78.     kann.
  79.  
  80.     Der Ausgabepfad muß die Endung ".RTF" haben.
  81.     Wenn kein Ausgabepfad angegeben wird, verwendet der Konverter den 
  82.     Dateinamen des Eingabepfades und ersetzt nur die Endung durch 
  83.     ".RTF".
  84.  
  85. Optionen:
  86.  
  87.     -fs
  88.         Bei Angabe von -fs wird auch für Pixelzeichensätze eine 
  89.         Größenangabe (\fs) in die RTF-Datei geschrieben. Der 
  90.         Konverter versucht in diesem Fall aus dem Fontnamen die 
  91.         Größe abzuleiten (z.B. 10pt für TIMES10.E24). Mißlingt 
  92.         dies, so wird als Größe 10pt gesetzt. Ohne Angabe von -fs 
  93.         verwendet der Konverter das Kommando \fsauto zur 
  94.         automatischen Einstellung der Fontgröße durch den Reader.
  95.  
  96.     -tab
  97.         Bei Angabe von -tab werden die Trennstriche von Tabellen 
  98.         mit ausgegeben.
  99.         Dies in derselben Form wie bei CyPress, d.h. als 
  100.         unterstrichene Tab's und mit zeilenhohen senkrechten 
  101.         Strichen. Für letzteres wird das selbstdefinierte Kommando 
  102.         \vline benutzt. Ohne Angabe von -tab werden die 
  103.         Trennstriche gefiltert.
  104.  
  105.     -rtf10
  106.         Bei Angabe von rtf10 werden einige Kommandos, die erst 
  107.         mit der RTF-Spezifikation Version 1.3 eingeführt wurden, 
  108.         nicht verwendet. (s.u.)
  109.  
  110. Kommandos aus der RTF 1.3 Spezifikation:
  111.  
  112.     \super
  113.         für Hochstellung (statt \up)
  114.  
  115.     \sub
  116.         für Tiefstellung (statt \dn)
  117.  
  118.     \nosupersub
  119.         zum Ausschalten der Hoch-/Tiefstellung
  120.  
  121.  
  122.     Für absolut positionierte Objekte in Formelzeilen:
  123.  
  124.     \phmrg\pvpara
  125.         Linke obere Ecke der Formelzeile als Referenz-Frame 
  126.                     
  127.  
  128. CYP2RTF verwendet noch folgende eigene Kontrollwörter, die von Readern, 
  129. die sie nicht kennen, ignoriert werden:
  130.  
  131.     \symbol
  132.         Das diesem Kontrollwort folgende Wort, d.h. bis zum 
  133.         nächsten Trennzeichen, ist ein Serienbriefsymbol. 
  134.         Reader, die das Kontrollwort nicht kennen, geben also 
  135.         einfach den Namen des Symbols aus.
  136.  
  137.     \groupn
  138.         n gibt die Nummer einer Gruppe an, zu der ein Formelobjekt 
  139.         gehört.
  140.  
  141.     \tchdecn
  142.         n gibt den ASCII-Code des Zeichens an, das im 
  143.         Linealbereich als Dezimaltab verwendet werden soll.
  144.  
  145.     \vline
  146.         An dieser Stelle soll eine zeilenhohe, vertikale Linie 
  147.         eingefügt werden. Wird von CyPress vor allem in Tabellen 
  148.         benutzt.
  149.  
  150.  
  151. Lob und Tadel bitte an folgende Anschrift:
  152.  
  153.     Stephan Lentz
  154.     Bahnhofstraße 1
  155.     67677 Enkenbach
  156.  
  157. oder im Mausnetz
  158.  
  159.     Stephan Lentz @ KL
  160.  
  161.  
  162. Hinweis:
  163.     Ich kann keine Haftung für irgendwelche direkten oder indirekten Schäden 
  164.     (einschließlich aber nicht beschränkt auf materielle oder finanzielle Schäden) 
  165.     übernehmen, die durch die Benutzung von CYP2RTF oder die Untauglichkeit von 
  166.     CYP2RTF für einen bestimmten Zweck entstehen.
  167.  
  168.  
  169. History:
  170.  
  171. v1.0 vom 7.9.94
  172.  
  173.     Erste öffentliche Version
  174.  
  175. v1.01 vom 21.10.94
  176.  
  177. -    Die Anweisungen für die Absatzfomatierung    erfolgen jetzt nach dem \par.
  178. -    Bei Tabellen wird der linke Rand auf den ersten Tab gesetzt und der Tab 
  179.     entfernt. Dadurch kann in papyrus ohne weitere Arbeit die Tabellenfunktion 
  180.     angewendet werden.
  181. -    Am Anfang eines Textobjektes steht jetzt die Anweisung \apoanchor zur
  182.     Positionierung des Textankers.
  183. -    In Textobjekten wird zunächst mit \pard die Formatierung auf die Default-
  184.     werte gesetzt.
  185.     
  186. v1.02 vom 9.11.94
  187.  
  188. -    Die Belegung des Ziffernblocks von Signum-Zeichensätzen wird nun korrekt 
  189.     behandelt.
  190. -    Nach Tabellen wurde der ersten normalen Textzeile das letzte Lineal vor 
  191.     der Tabelle zugewiesen.
  192.     
  193.